home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 20 / Cream of the Crop 20 (Terry Blount) (1996).iso / os2 / gjboxx25.zip / READTHIS < prev   
Text File  |  1996-05-13  |  5KB  |  134 lines
  1.                      Grin's Simple MIDi Jukeboxx
  2.                      ============================
  3.  
  4.                      Version 2.50
  5.                      1996 May
  6.  
  7.  
  8.            This program is freeware for non-commercial environments
  9.  
  10.  
  11.  
  12.         Hello music lovers!
  13.  
  14.  
  15. This is my attempt to stop my anger because IBM's MIDi player is
  16. unable to use playlists. This simple player plays all MIDi files
  17. in the actual directory (or anywhere if you enter it on command
  18. line or in a playlist file), then stops. 
  19.  
  20.  
  21.          About the REXX language
  22.          ~~~~~~~~~~~~~~~~~~~~~~~~~
  23.  
  24. I wrote it in REXX because it's completely fits the purpose. So you
  25. got the sources, too. ;-) Feel free to read the code, or modify if
  26. you like, but please do not distribute modified versions but send
  27. them to me, I will distribute them if they worth it. ;-)
  28.  
  29. The program uses very low CPU since it "sleeps" most of the time.
  30. Don't worry when you press a key and nothing happens: the program
  31. checks the input only in every seconds, and so refreshes the screen.
  32. (On my machine it uses as low as 7% or the CPU.)
  33.  
  34. The program usage is in the REXX source, just check it. But you
  35. can simply start the program in a directory where some *.MID file
  36. resides.
  37.  
  38.          
  39.          Some volume tricks
  40.          ~~~~~~~~~~~~~~~~~~~~
  41.  
  42. If you're in a night family environment :) you should check the source
  43. for the starting volume and lower it if you're that lazy to make your
  44. 500+ watts stereo more quiet... :-) You can set it anytime on command
  45. line, though.
  46.  
  47. I especially wonder whether there is any soundcard able to set the
  48. volume in stereo. Mine (Gravis Ultrasound) seem to have a driver
  49. unable to do that. Others reported that theirs are also unable to
  50. do it. I try to detect the sound card's ability and use stereo only
  51. when it's supported, but... I don't _know_ that it's correct as I
  52. wrote it. :)
  53.  
  54.  
  55.          Usage
  56.          ~~~~~~~
  57.  
  58.     MidPlay [<file pattern>] [@<playlist name>] [<file pattern>] [switches]
  59.   
  60.   Switches:  /V<vol>   Set global volume (0-100)
  61.              /R<vol>   Set right volume (0-100, stereo capable only)
  62.              /L<vol>   Set left  volume (0-100, stereo capable only)
  63.              /S        Shuffle play - play songs in random order
  64.  
  65. You can use file patterns like names in actual directory ("YELLOW.MID"),
  66. full path ("C:\OOKIE\AmericanPie.Mid"), wildcards ("C:\ATS\*.mid").
  67.  
  68. Playlists are simple text files containing one filename in a line,
  69. unlimited lines. Names could contain full path or just the name, but
  70. not wildcards. (You shouldn't be THAT lazy! :-))
  71.  
  72. The order of patterns, playlists and switches are irrelevant. 
  73.                                                       -- Midplay of Borg
  74.  
  75.   Examples:
  76.     MidPlay
  77.       Plays all *.MID files in the current directory
  78.  
  79.     MidPlay /S E:\TMP\MIDI\A*.MID M:\IDI\"C64 Evergreens"\*
  80.       Plays the given files of the given directory, shuffled
  81.  
  82.     MidPlay TheSatan.Mid @hellish.list /v80
  83.       Plays the Satan's song then all files in the playlist, volume 80%
  84.  
  85.  
  86.          What's new, history, etc
  87.          ~~~~~~~~~~~~~~~~~~~~~~~~~~
  88. Why do you ask me? Check the source! :-) 
  89. (You got all my sources, remember? :))
  90.  
  91.  
  92.          Standard worm...er... lawyer stuff
  93.          ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  94.  
  95. The program is free if you run it in an environment where no commerce
  96. has gone before! :-) But since I'm a poor Hungarian guy I always
  97. accept donations in money, food, drink computer parts or girls. ;-)
  98. You can contact me at the addresses below. (I can accept cash or 
  99. bankchecks only.)
  100.  
  101. If you're a commercial user please support me (and the development
  102. of several OS/2 programs) and send an amount as low as USD 10 to my
  103. address as a registration fee. (You can send more of course.)
  104.  
  105. Of course you don't want to tell me that you want any guarantees from
  106. a FREE program, do you? But the program usually plays what it should,
  107. and that's more than the Warp's current players do. :) If it deletes
  108. your CD drive, eats your lunch or take your sister to a movie - bad 
  109. luck. :-> You have my full sympathy.
  110.  
  111. My support is virtual. That means I support any requests unless 
  112. I'm swapped out because out of time. :-)
  113.  
  114.  
  115.          Your support!
  116.          ~~~~~~~~~~~~~~~
  117.  
  118. I'd like to hear about you! Send me a mail about how did you like
  119. this piece of code! 
  120.  
  121. Happy Jukeboxxing!
  122.  
  123.  
  124.  
  125.          Author on the bridge!
  126.          ~~~~~~~~~~~~~~~~~~~~~~~
  127.  
  128. Peter Gervai               2:370/15@fidonet           Sysop of LifeForce BBS
  129. Debrecen, 4026            81:436/3@OS2net
  130. Zsak str. 7.              grin@LifeForce.fido.hu
  131. HUNGARY
  132.  
  133.                     (Member of TeamOS/2 Hungary)   
  134.